Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Undo for Tracks

NewTrackEditState

You can create an edit state by calling the NewTrackEditState function. This function creates an edit state that contains all the information describing a track's content, including the identity of the media data associated with the track and all the track's
edit lists.

Note

You must dispose of a movie's track edit states before disposing of the track or of the movie that contains the track. Use the DisposeTrackEditState function, which is described on page 2-254, to dispose of an edit state.

pascal TrackEditState NewTrackEditState (Track theTrack);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

DESCRIPTION

The NewTrackEditState function returns a track edit state identifier. You can use this identifier with other Movie Toolbox edit state functions, such as UseTrackEditState (described in the next section). If this function could not create the edit state, it sets this returned identifier to nil.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

Memory Manager errors